perm filename ERRATA.BH[S,DOC]3 blob
sn#098347 filedate 1974-04-25 generic text, type T, neo UTF8
STANFORD ARTIFICIAL INTELLIGENCE LABORATORY April, 1974
OPERATING NOTE 54.3 1/2
M O N I T O R C O M M A N D M A N U A L
(addenda and errata)
by
Brian Harvey
This document contains corrections and additions to the Monitor
Command Manual, SAILON 54.3, reflecting improvements in the system
facilities as of the date above. A line printer version of this
document is available for network users in the file ERRATA.BH[S,DOC].
This work was supported by the Advanced Research Projects Agency of
the Office of the Secretary of Defense under contract
DAHC15-73-C-0435.
Monitor Command Manual (addenda and errata) 1
------
The first sentence of the third paragraph on page 4 (section 1.3)
should be replaced as follows:
A vacant terminal should say TAKE ME I'M YOURS! along with a line of
cryptic information on an otherwise blank screen. The cryptic
information is the system WHO line, described on page 17.
______ ___ _____
------
The following lines should be added to the device table on page 7
(section 1.5) The old AD device is still present but not for long.
IMP Interface Message Processor for ARPA network connections
ADC Analog to digital converter
DAC Digital to analog converter
------
Add the following paragraph to the description of the audio switch
escape commands on page 21 (section 2.9):
Your program can control the audio switch selection for your terminal
by UUO. Although programs cannot in general change the audio switch
setting for another terminal, there is a BEEP UUO which can be used
to cause any terminal's loudspeaker to be connected to the beep
generator for a short time (less than one second). This is used by,
e.g., the SEND command to call the recipient's attention to a message
on his screen. You can permit or refuse such beep connections by UUO
or by escape commands; BREAK B refuses beeps, and ESC B permits them.
Any change to your audio switch setting by other means (e.g. ESC U)
also cancels the effect of BREAK B, so you must repeat the BREAK B
command after changing your selection.
------
Add the following paragraph to section 4.2, page 24:
If your core image includes an upper segment (see page 11), you can
set or clear the write protection bit with the SETUWP or CLRUWP
commands. You cannot clear write protection for a sharable upper
segment if it is protected against you. (See the UUO Manual for a
___ ______
complete discussion of upper segment protection.) These commands also
take an optional octal argument, which is used to set the protection
code for the segment if you are permitted to change the code.
Monitor Command Manual (addenda and errata) 2
------
Add the following sentence to the description of the START command on
page 25 (section 4.3):
If the octal argument is preceded by + or -, the number is added to
or subtracted from the program's normal starting address to determine
the desired starting address.
Also add the following sentence to the description of the REENTER
command on the same page:
An octal argument preceded by + (optional in this case) or - will be
added to or subtracted from the reenter address.
------
Add the following sentence to the description of the FORK command on
page 26 (section 4.4):
If the system's job capacity is used up, so that it is impossible to
start a new job, your terminal remains attached to the existing job.
------
Add the following sentence to the description of the command TIME 0
on page 28 (section 4.6):
It also types the percentage spent in the monitor at interrupt level,
but this information is provided for the benefit of system wizards
and is not particularly meaningful to users.
Also, add this to the description of the DAYTIME command on that
page:
If the job has been logged in since the previous day, dates (day of
the month) are typed along with the three times.
Monitor Command Manual (addenda and errata) 3
------
Replace the first two sentences on page 31 (section 5.1, LOGIN) with
the following:
If you log in from a remote terminal (by a dial-up telephone line) or
via the ARPA network, you may be asked for the remote users password,
______ _____ _________
which is used to discourage unauthorized use of the system. If the
PPN under which you wish to log in has its own password, you are not
required to know the remote users password. Also, the PPN NET,GUE
(network guest) is allowed to log in without the password. (Instead,
if you log in as NET,GUE you will be asked to type in your name. Any
name you give is accepted and stored to identify your job as long as
you remain logged in.) Users with access to local terminals who
sometimes need to log in remotely can set a password (with %) for
their own PPNs; remote users who want to establish their own file
directories should communicate with Lester Earnest. (Log in as
NET,GUE and type MAIL LES.)
------
Add the following at the end of the LOGOUT description (page 33,
section 5.2):
Any of these commands, when typed at a PTY which is not owned by a
TELNET server (that is, not the virtual terminal of an ARPA network
user), simply kills the job without running the LOGOUT program. This
has approximately the effect of KJOB/F.
------
The second line of the table of compile-type RPG commands on page 33
(section 5.3) should be:
LOAD compile and load programs
------
Replace the description of SYSTAT on page 40 (section 5.11) with
The SYSTAT command runs the WHO program (see section 5.9). The old
SYSTAT program is no longer supported on this system, but the command
name was retained for compatibility with other systems.
Monitor Command Manual (addenda and errata) 4
------
Delete the sentence beginning "If you end the command line with ALT
..." in the description of the TELNET command on page 41 (section
5.12). The effect formerly achieved by ALT is now used automatically
in all cases. Also, add the following paragraph after the TELNET
description:
It is possible to establish TELNET-like connections to remote
computers by using dial-up connections via the dataphones normally
used for incoming dial-up lines. Such dataphones are presently
associated with TTY10 and TTY11; the dataphone on TTY11 includes an
automatic dialing circuit. The DIAL command will establish an
outgoing dataphone connection and thereafter behave like a TELNET.
The dial command takes as its argument either the device name of a
TTY, in which case you must dial the number you want manually on the
associated dataphone, or a telephone number in the form
{(ddd)}ddd{-}dddd
where d represents a digit and braces enclose optional characters.
In the latter case, the telephone number is dialed automatically on
TTY11's dataphone.
------
Add the following to section 6, page 42:
Privileges can be enabled or disabled at any time. That is, for each
job, the monitor remembers the privileges to which the job is
entitled as well as the ones which are presently active. All
privileges to which you are entitled are normally activated when you
log in, but you may choose to disable any or all for safety reasons.
The ENABLE and DISABLE commands, with no arguments, turn on or off
all privileges to which you are entitled. These commands may also be
used with a privilege name as argument, to enable or disable specific
privileges. If you have the PRI privilege, you can enable specific
privileges to which you are not entitled, except that privileges
which are intended only for specific programs (XGP font compiler,
service level monitor) cannot be enabled by any user.
Monitor Command Manual (addenda and errata) 5
------
In the description of the CETV and ETV commands on page 44 (appendix
1), in the last line of the paragraph numbered 1, the word "of"
should be "if". Also, delete the last sentence in the last paragraph
on that page, numbered 3. (TMPCOR files for each job are now saved
separately for each alias used by that job.)
------
Insert the following on page 60 (appendix 2, COPY), before the
"Switches" section:
Spooling pseudo-devices:
COPY recognizes two pseudo-device names, TPL: and PGX:, to allow
spooling of the output of some copy function to the LPT or XGP,
respectively. These device names may be used only in output terms,
and may not be used with file names. COPY creates a file on the
[SPL,SYS] directory containing the desired output, and enters a
spooling request for the appropriate device. The file is deleted
after spooling. For a standard COPY command, the effect is
essentially equivalent to the recommended SPOOL/RECOPY (see page 66);
the main advantage of this capability is for direct spooling of list
terms, e.g.,
DIRECT TPL:←[*,SYS]
to spool a list of the [*,SYS] file directories. (Note: It is
claimed that these pseudo-device names stand for The Pseudo Lpt and
Pseudo Graphic Xerox-machine respectively.)
Monitor Command Manual (addenda and errata) 6
------
In the list of COPY switches (page 61, appendix 2), add this entry:
NOSPACES NOS This switch eliminates spaces at the end
of a line.
Also, on page 62, add /REFERENCE and change the abbreviation for
/RENAME as follows:
REFERENCE REF This switch is like /SEARCH below, but
includes in the directory listing an extra
column containing the date on which each
file was last read (referenced by LOOKUP).
RENAME REN A rename is done on the input file with
the output file information. /QUIET
applies when the output filnam.ext already
exists.
------
In the table of spooler switches (page 66, appendix 3), the entry for
/REPEAT should be
REPEAT=n Make n copies of the listing. (REPEAT is NOT sticky,
and is not allowed in XSPOOL.)
------
Insert the following on page 66 (appendix 3, SPOOL), before the
"Delayed Listing" section:
File specifications may be read from an auxiliary file by including
in the command line the name of the auxiliary file preceded by @.
This file may include file names and switches.
Monitor Command Manual (addenda and errata) 7
------
Add the following to the table of XSPOOL switches, page 68:
NOXGP Opposite of /XGP.
NTNODE=n Sets the number of text nodes allocated by the
monitor (see below).
NVNODE=n Sets the number of vector nodes allocated.
Also add the following at the end of page 68:
Text nodes and vector nodes are units of core storage allocation used
____ _____ ______ _____
by the monitor's XGP service routines. Generally, you need not worry
about them, but if you have trouble printing a complex document the
allocation control switches may be able to help you. See a system
wizard to find out.
The /XGP switch, when present, turns off the usual default
assumptions about other switches; in particular, /HEADING is not
assumed unless it is explicitly used. Spooling a file with extension
.XGP implies a default of /NONUMBER as well as /XGP.
------
Add the following paragraphs to the QSPOOL and XSPOOL descriptions
(page 69, appendix 3):
The commands QSPOOL/LPT and QSPOOL/XGP will list spool requests only
for the indicated device.
The commands UNSPOOL/LPT and UNSPOOL/XGP will list and delete spool
requests only for the indicated device.
Monitor Command Manual (addenda and errata) 8
------
On page 72 (appendix 4, MAIL), replace the paragraph starting "The
check for a file..." as follows:
The check for a file directory for the specified user(s) is made
before the program asks for the message if the multi-line option is
used. If there are no valid destinations, the program exits without
doing anything else. If any destinations are valid, however, the
program asks if you wish to continue, and if so it continues as if
only the valid destinations were specified. (Exception: The list
provided by /D includes all specified destinations, valid or
invalid.) The special case of a command like SEND PRJ,PRG where what
is meant is SEND [PRJ,PRG] will be caught if PRJ is not the name of a
programmer, and the (probable) desired effect is simulated with a
warning message given. Note: in the case of SEND, the only check
made before the message is typed in is the file directory check. The
check for the user(s) being logged in is not made until later.
------
On page 74 (appendix 4, MAIL), in the paragraph starting "The
optional count field..." replace "#ffl" with "#∞".
------
Add the following paragraph above the last paragraph on page 74
(appendix 4, MAIL, description of REMIND command):
Since the structure of the reminder queue is rather sensitive to
incorrect date and time information, the current date and time
according to the monitor are checked for reasonableness against the
reminder file. If they are considered unreasonable, no reminders
will be accepted or delivered until the system has been up for at
least five minutes. (Hopefully by then an incorrect date or time
entry will have been noticed and corrected.)
Monitor Command Manual (addenda and errata) 9
------
Add the following entry to the table of RCV options on page 76
(appendix 4):
P Postpones the decision for a long message (see below)
Also, add the following to the paragraph concerning long messages on
page 77, starting "It is possible...."
If you wish, you may postpone the decision on how to process the
message until after seeing the rest of it, by typing P to the option
request. This will type the remainder of the message and ask again
for an option. QP is illegal, and P is only legal when a message
overflows.
------
In the table of DART monitor commands on page 78 (appendix 5), the
entries for LOCATE and TLIST should be:
LOCATE {<dest>←}{<source>}
TLIST {<dest>←}{<source>}
------
Add the following after the second line on page 88 (appendix 8,
ARPA):
The information which follows also applies to the DIAL program, a
version of T which uses dial-up telephone connections rather than the
ARPA network. The format of the DIAL command is explained on page
41.
Monitor Command Manual (addenda and errata) 10
------
In the list of telnet control commands starting on page 88, change
the entry for ⊗H to <arg>⊗S. (The ⊗H in the text of that entry must
also be changed to ⊗S.) The existing entry for ⊗S should now say "⊗S
(no arg)". The following entries should also be modified as shown
here:
βE Begin local echoing. Also attempts to turn off remote
echoing. Different sites have different echoing
conventions. Some sites expect to send back echoing, some
do not. If you find that what you type is not being echoed
in a reasonable time, you may use this command to let you
see what you are typing. In the DIAL prgram, this makes you
look like a half duplex terminal, and does not change the
state of remote echoing.
αβE Terminate local echoing. Also attempts to turn on remote
echoing. One does this when each key one types appears
twice on the console. Turning off local echoing will often
eliminate one copy of the key. The DIAL program does not
attempt to change the state of remote echoing.
Also add the following new control commands:
βO Turn on console typeout. See αβO.
αβO Turn off console typeout. Useful when output is already
going to a file and you don't want to waste the time it
takes to type out on your console as well.
⊗C (TELNET only) Send interrupt. This is the network protocol
for "return to monitor" or equivalent.
βC (DIAL only) Turn on control character mode. In this mode
all characters received from the dataphone are typed on your
console.
αβC (DIAL only) Turn off control character mode. In this mode,
octal codes 1-10, 16-37, and 177 are not typed on your
console when received from the dataphone.
------
On the third line of the FTP description on page 90, "⊗FTP←" should
be "FTP".
Monitor Command Manual (addenda and errata) 11
------
In the description of the XGP on page 97 (appendix 9), delete the
reference to the VERTICAL POSITION knob. This knob may be in any
position, and should not normally be changed by users.
------
Replace the last paragraph on page 100 (appendix 9, fixing memory
stops) as follows:
Once the memory is reset, the computers have to be convinced that
nothing bad happened. To do this on the PDP-10, the USER MODE light
on the console must be off. If it is on, first turn on the SINGLE
INSTRUCTION switch on the console, then push CONTINUE. This should
turn off the USER MODE light. Then turn off the SINGLE INSTRUCTION
switch. When the USER MODE light is off, enter 700200 010003 in the
data switches and push the EXECUTE key. If the MEMORY STOP light on
the PDP-6 is on, follow the same procedure as on the PDP-10.
(Instead of a USER MODE light on the console, the PDP-6 has an EXEC
MODE light at the top of the second bay to the left of the console;
this light must be on for the execute.) Finally, push CONTINUE on
both machines.
------
Replace the last paragraph on page 101 (appendix 10, reloading) with
the following:
If this procedure fails, check that the NXM STOP switch on the
console is turned on; then check the following switches, located
inside the second door to the left of the console: JSYS ENB and MAPAC
ENB off, MA TRP OFFSET on.
If the system loader tape still fails, find the DECtape with the
current system. The DECtape will be labeled with the system name and
date. Mount it on some DECtape drive. Find the paper tape labeled
256K TENDMP or 128K TENDMP, and load it into the paper tape reader
(on the PDP-10). Stop the PDP-6. Press RESET and READ IN on the
PDP-10. The paper tape will be read, and the CTY will type carriage
return and line feed. Type n$ where n is the number of the DECtape
drive and $ is an alt mode. The DECtape should spin for a while,
then it will stop and the CTY will type crlf again. Type
L$SYSTEM SAV (note the space before SAV, not a period) then carriage
return. The DECtape will spin again, followed by another crlf. Type
206$ then G$ to start the system. (If the Librascope disk is down,
type 200$G$ instead.)
Monitor Command Manual (addenda and errata) 12
------
The following monitor error messages should be added to the list in
appendix 11, starting on page 102, in alphabetical sequence:
ILLEGAL ADDRESS FOR ADC-DAC
The PDP-6 has detected an illegal address which you
specified to be used for some function connected with the
ADC or DAC device. This was not detected when your program
executed a UUO, but asynchronously, in the device service
program running on the PDP-6.
NO SUCH PRIVILEGE!
The privilege name specified in an ENABLE or DISABLE
command does not exist.
NO UPPER SEGMENT!
You typed a SETUWP or CLRUWP command and your core image
does not include an upper segment.
NOT ONE OF YOUR JOBS.
You typed a KILL command with a job number not belonging to
your programmer name.
SORRY, PROTECTION FAILURE!
You typed a SETUWP or CLRUWP command, and are not permitted
to change the write protection of your core image's upper
segment.
SORRY, YOU CAN'T HAVE THAT PRIVILEGE!
You typed an ENABLE command specifying a privilege name,
and neither the privilege you specified nor the PRI
privilege is in the list associated with your PPN; or the
privilege is one which is not permitted to any user (XGP or
SSL).
USE "KJOB" TO LOG YOURSELF OFF.
You typed a KILL command with your own job number as the
argument.
Also, add "or KILL" after "ATTACH" in the description of the
NO SUCH JOB message, and remove the reference to the KILL command in
the description of the OUT OF BOUNDS message.
Monitor Command Manual (addenda and errata) 13
------
Add the following to the monitor command summary, pages 118 and 119:
NAME DESCRIPTION
CLruwp clear upper segment write protect
DIAl talk to computer by telephone
DISable ⊂ disable privileges ⊃
ENable ⊂ enable privileges ⊃
SETuwp set upper segment write protect
NAME PROGRAM ARGUMENTS PAGE
CLruwp {prot} 24
DIAl DIAL dv | phone 41
DISable ⊂ {priv} ⊃ 42
ENable ⊂ {priv} ⊃ 42
SETuwp {prot} 24
Also, the following should be added to the list of abbreviations on
page 117:
prot octal protection code
phone telephone number, format {(ddd)}ddd{-}dddd
priv privilege name
------
I am not in general trying to maintain the index, either to fix
errors or to add new entries. However, one particular omission has
been mentioned to me several times by irate users:
LOADER switches 54